IDS Software Suite 4.90.06 for Linux

System requirements   ⇑

For operating the uEye cameras, the following system requirements must be met:

Depending on the sensor model, the camera performance may be limited with the minimum system requirements.

Compatibilty list

The Linux operation system is one of the most widely ported, running on a huge amount of architectures and provided over many distributions. Although we are trying to be compatible among the whole range of kernel versions and distributions, there is no guarantee that the IDS Software Suite is working on a specific untested combination.

Below is a list of tested and succeeded platforms and distributions for the current software release:

Configuration notes   ⇑

• According to the IDS Software Suite version, the Linux system has to support a minimum required version of the GNU C Library (GLIBC, libc.so.6) and the GNU C++ Library (GLIBCXX, libstdc++.so.6), see https://en.ids-imaging.com/download-ueye-emb-softfloat.html?file=tl_files/downloads/LinuxEmbedded/IDS_uEye_for_Embedded_Boards_EN.pdf:
  • libc: minimum version 2.7
  • libstdc++: minimum version 3.4.17
• POSIX threads library (POSIX threads enabled libc)
• bash (Bourne again shell) or sh to run the script
• libcap v2
• libgomp v2 (for OpenMP support)
• udev min. v105
• libpng (libpng.so or libpng12.so.0) for support of saving images in PNG format
• libjpeg (libjpeg.so.8 or libjpeg.so.62) for support of saving images in JPEG format and JPEG mode of XS
• OpenGL graphics functions
  For OpenGL, version 1.4 or higher must be installed.
• If you want to have a graphical environment by using tools like the IDS Camera Manager or the uEye Demo application, you need to install the Qt framework (min. v4.5.2)
• Installation of IDS Software Suite 4.81 (or higher) will break USB driver installations prior to 4.81

Installation   ⇑

You must be root to install.

• You must be root to control the daemon.

1. Copy all the files into a directory on the hard disk (you need write access to decompress).
2. Go to the directory you copied the files into and run the setup program script by typing (replace the wildcard with the actual version identifier of the installer file) $> sh ./ueyesdk-setup*.run
3. If any problems occurred, the known issues section below or the generated report.log file may include a hint to solve them (see installer output). If not, contact your local distributors support and submit the report.log file.
4. If installation succeeded, one may start the uEye daemon by typing /etc/init.d/ueyeethdrc start (you need to be root)
   To stop the uEye daemon, type /etc/init.d/ueyeethdrc stop
   For USB uEye, replace 'ueyeethdrc' with 'ueyeusbdrc'.
   Alternatively, if one has a working graphical environment, the daemons may be controlled via the IDS Camera Manager (started as root)
5. Set camera ID
   To set the camera ID, one may use the IDS Camera Manager or the 'ueyesetid' tool.
6. Set camera IP
   To set the camera persistent IP address, one may use the IDS Camera Manager or the 'ueyesetip' tool.
7. If the uEye daemon hangs and can not be stopped with /etc/init.d/ueyeethdrc stop, run (as root) /etc/init.d/ueyeethdrc force-stop
   Note that it is normal behaviour that ueyeethd refuses to terminate if there are applications connected.
   For USB uEye, replace 'ueyeethdrc' with 'ueyeusbdrc'.

Installed file structure

The created files will be installed in following directories when installing the USB package:

Additionally, the installer provides the following tools - unless not indicated otherwise, the tools will be installed to /usr/local/share/ueye/bin:

For the binary tools, a symbolic link will be created in /usr/bin to provide direct command line access.

User/group

The installer will create a system group 'ueye' and a system user 'ueyed' to run the daemon with. Currently there are no access control restrictions, but be aware that this might change in the future.

First start   ⇑

USB 3.1/USB 3/USB 2 uEye camera

After you installed the software, connect the camera to the PC, using the corresponding USB cable. The camera will be recognized automatically. When you connect a camera with a PC or a new USB port for the first time, it is detected as a new device and the firmware is uploaded to the camera. When the camera has been correctly installed, the LED on the back of the camera lights up green and the camera is displayed in the list of the IDS Camera Manager.

Known issues   ⇑

This section lists known issues that might occur in this release.

• Energy saving issues: On some systems with activated energy saving, the daemons may hang once the system has entered an energy saving state.
• USB 3.0 issues: Sometimes the USB daemon cannot receive data from the camera which is connected on a USB 3.0 port. After that occurs, physically disconnect the camera and reconnect it.
• USB 3.0 performance issues: High CPU load may lead to USB transfer fails. They possibly can be reduced by:
  • Increasing the daemon priority by reducing the NICEVALUE in /etc/init.d/ueyeusbdrc
  • Increasing the number of pending USB requests with the following configuration of /usr/local/share/ueye/ueyeusbd/ueyeusbd.conf:
    [Parameters]
NumRequestsStr = 40 ;
• OpenMP issues may be cause high CPU load or "Driver out of buffer" errors. They possibly can be reduced by:
  • Setting the value of the environment variable OMP_WAIT_POLICY to PASSIVE
    This variable specifies whether waiting threads should be active or passive. If the value is PASSIVE, waiting threads should not consume CPU power while waiting; while the value is ACTIVE specifies that they should. If undefined, threads wait actively for a short time before waiting passively.

List of contained files / dependencies   ⇑

See list on https://en.ids-imaging.com/open-source.html

Uninstallation   ⇑

• To uninstall ueyeusbd, run (as root): /usr/local/share/ueye/bin/ueyed_install-usb uninstall

You should always use the install script that came with the previous installation to ensure proper system cleanup. Do not attempt to remove the IDS Software Suite manually.

Note: Once uninstalled, any configuration file will be lost. Consider backing up the respective configuration files!

Copyright / Trademarks   ⇑

© 2018, IDS Imaging Development Systems GmbH

IDS Imaging Development Systems and uEye are registered trademarks of IDS Imaging Development Systems GmbH.

IDS Imaging Development Systems GmbH
Dimbacher Str. 6-8
74182 Obersulm, Germany
http://www.ids-imaging.com